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Return 
Value: 


Routine Name: 


Arguments: 


Description: 


char* 


vcuAHocateBuffer( . ) 


int channel 


Allocates a buffer with proper caching 
properties, sized for the specified channel 


unsigned int 


x/fiif^lparFrrnof \ 


none 


Returns the first recorded VCU error # and 
dears it from the error system 


void 


V^UvUI 1 II 1 III m\>/ 


none 


Starts the VCU service 


void 


vcuCommHa1t(.) 


none 


Forcefully halts all VCU-related tasks 


int 


vcuDataS*ize(.) 


int channel 


Returns the maximum message size, in 
bytes, for the specified channel 


unsigned int 


vcuErrno(.) 


none 


Returns the first recorded VCU error # 


int 


vcuFree(.) 


int s» hann^l rnnd rhar *data 


Marks the specified memory location in the 
socket Rx memory pool as usable (see 
detailed description) 


void 


vcuFreeBuffer(.) 


int channel, char *buffer 


Frees a buffer allocated with the 
vcuAllocateBuffer(.) routine 


int 


vcuHasPushQueueMessage(.) 


int channel 


Returns the number of messages in the 
push queue for the specified channel 


int 


vcuHasRxQueueMessage(.) 


int channel 


Returns the number of messages queued 
for the specified channel 


int 


VCUiraC6r13SrvXLJ3ldVJUt:ut;rvieoo 


none 


Returns the number of vcuRecv(.) replies 
queued 


int 


vculfaceHasRxRqstQueueMessage(.) 


none 


Returns the number of vcuRecv(.) calls 
queued 


int 


vculfaceHasTxQueueMessage(-) 


none 


Returns the number of vcuSend(.) calls 
queued 


int 


vculfaceHasTxReplyQueueMessage(.) 


none 


Returns the number of vcuSend(.) replies 
queued (used for push configs) 


int 


vculfaceHasTxStatusQueueMessage(.) 


none 


Returns the number of vcuSend(.) status 
messages queued 


int 


vculsMemPairPoolEmpty(.) 


none 


Returns 0 if the mem pair pool (used for 
push configs) is not empty and a non-zero 
value if it is empty 


int 


j vculsRxPoolEmpty(.) 


int channel 


Returns 0 if the receive pool for the 
specified channel is not empty and a non- 
zero value if it is empty 



Figure 3(a) 
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Return 
Value: 


Routine Name: 


Arguments: 


Description: 


int 


vculsTxPoolEmpty 


int channel 


Returns 0 if the transmit pool for the 
specified channel is not empty and a non- 
zero value if it is empty 


int 


vcuPing(.) 


int destination 


Cjiecks that a remote board is reachable 
via VCU. If more than one bit is set, a table 
is printed 


void 


vcuPrintChannellnfo(.) 


int channel 


Prints out the configuration information for 
the specified channel. If the argument is 0 
(default), a table is printed 


void 


vcuPrintDebug(.) 


int debugLevel 


Triggers a printout of debugging data 


int 


vcuQueryForConfigC) 


int channel 


Returns the configuration of the channel for 
internal VCU use (defined in vcuDefines.h) 


unsigned int 


vcuRecentErrno{.) 


none 


Returns the last recorded VCU error 
number 


int 


vcuRecv(.) 


See Detailed Description 


See Detailed Description 


int 


vcuRequestErmo(.) 


int destination 


Receives the VCU enor # from a remote 
board. If more than one bit is set a table is 
printed 


int 


vcuRequestTestPattern(.) 


int destination, int channel, 
int msgSize 


Requests a remote board to send a pre- 
defined test pattern of a requested size, 
and prints out success or error of delivery 


int 


vcuSend(.) 


See Detailed Description 


See Detailed Description 



Figure 3(b) 



Debug Level: 


Description: 


1 


Prints out the use status of all Rx memory pools 


2 


Prints out the use status of all Tx memory pools 


3 


Prints out the use status of all Rx and Tx memory pools 


4 


Prints out detailed information about each slot of all Rx memory pools 


5 


Prints out detailed information about each slot of all Tx memory pools 


6 


Prints out detailed information about each slot of al) Rx and Tx memory pools 


7 


Prints out the status of all Rx queues 


8 


Prints out the status of all push queues 


9 


Prints out detailed information about each slot of memPair memory pool 


101 


Prints out internal timing information if the system has been instrumented for timing 



Figure 4 
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Docket # 



Configuration Type: 


Sender Side: 


Receiver Side: 


Copy on Send 


while(RUNNING){ 
vcuSend(dest, chan, data, size); 

} 


while(RUNNINGK 
vcuRecv(chan, pAddr, size); 
//Handle message at pAddr 
//(size in bytes length) 
vcuFree(chan, pAddr); 

} 


Copy to Pool on Receive 


while<RUNNINGM 
vcuSend(dest, chan, data, size); 

) 


while(RUNNINGK 
vcuRecv(chan, pAddr, size); 
//Handle message at pAddr 
//(size in bytes length) 
vcuFree(chan, pAddr); 

} 


Copy to Buffer on Receive 


while(RUNNING){ 
vcuSend(dest, chan, data, size); 

} 


buf = vcuAllocateBuffer(chan) 
while(RUNNINGK 

vcuRecv(chan. buf, size); 

vcuFree(chan, buf): 

vcuFreeBuffer(chan, buf); 
} 


Push to Pool on Receive 


int pAddr = 0x0 
int id = UNIQUE VALUE 
while(RUNNINGX 
vcuSend(dest, chan, data, size, pAddr, 
id); 

} 


while(RUNNINGK 
vcuRecv(chan, pAddr, size); 
//Handle message at pAddr 
//(size in bytes length) 
vcuFree(chan, pAddr); 

} 


o,,ch *r\ Duff or nn Rpceive 


int pAddr = 0x0 
int id = UNIQUE.VALUE 
while(RUNNING){ 
vcuSend(dest, chan, data, size, pAddr, 
id); 

//Changes in pAddr indicated when data 
//was read 

} 


buf = vcuAllocateBuffer(chan) 
while(RUNNlNGM 

vcuRecv(chan, buf, size); 

vcuFree(chan, buf); 

vcuFreeBuffer(chan, buf); 


Queue on Send 


while(RUNNINGK 
vcuSend(dest, chan, data, size); 

} 


buf = vcuAllocateBuffer(chan) 
while(RUNNINGK 

vcuRecv(chan, buf, size); 

vcuFree(chan, buO; 

vcuFreeBuffer(chan, buf); 


Copy to Self 


while(RUNNING){ 
vcuSend(dest, chan, data, size); 

> 


while(RUNNINGH 
vcuRecv(chan, pAddr, size); 
//Handle message at pAddr 
//(size in bytes length) 
vcuFree(chan, pAddr); 

> 


Overwrite on Send 


while(RUNNlNG){ 
vcuSend(dest, chan, data, size); 

} 


while(RUNNING){ 
vcuRecv(chan, pAddr, size); 
//Handle message at pAddr 
//(size in bytes length) 

} 
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VCU Socket Task 
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from the header at the received memory 

location. 

Copy the data, including the data size 
portion of the header, to the Rx memory 
pool. 

Convert the received memory location to 
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Enqueue the Rx memory pool memory 
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Figure 6(a): The sending sequence for the "Copy on Send" 
configuration. 
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Application (108) 



vcuSendO 

Call vcuSocket.SendO 

**Copy header and data to Tx 

memory pool. 

""Flush cache of memory 

location in pool 

**Write memory location in 

pool (seen from VME bus) to 

mailbox 1 on destination 

board. 
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**Copy the data, including the data 
-size portion of the header, to the Rx 
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**Convert the received memory 
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Figure 6(b) 

(sending s qu nc for copy on send configuration with VCU Tx Task removed) 
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ure 7(a): The receiving sequence for the "Copy on Send" configuration. 
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"Receive from the vcuSocket queue, 
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"Write the value received into the 

appropriate argument. 

"Return status. 

"Set the message size to the value in the 
header of the message stored at the 
location indicated in the return value. 
"Set the message location in the input 
argument 



Figure 7(b) 

(receiving sequence for the copy on send configuration with the VCU Rx Task removed) 
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Read request from msgQ (wait forever). 
Call vcuSocketUpdateO 

• Copy header and data to Tx memory 
pool. 

• Flush cache of memory location in 
pool. 

• Write memory location in pool (seen 
from VME bus) to mailbox 1 on 
destination board. ^ 

• Read from msgQ. Return a fail value 
on timeout. 

• Return status 
Enqueue status. 
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board. 
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VCU Socket Task 



Read a value from msgQ(wait forever). 
The value is interpreted as a memory 
location on the VME bus. 
Read the channel and priority from the 
header at the received memory location. 
Enqueue the memory location in the 
vcuSocket queue. 



Receiving Board 



Figure 8(a): The sending sequence for the "Copy to Pool on Recv" configuration. 
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vcuSendO 

Call vcuSocket.SendO 

**Copy header and data to 
Tx memory pool. 
"Flush cache of memory 
location in pool 
"Write memory location in - 
pool (seen from VME bus) 
to mailbox 1 on destination 
board. 

"Read from msgQ. Return 
a fail value on timeout. 
"Return status 
Return status 
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Mailbox Handler (Mailbox 1) 



"Write received value (with first 
byte indicating status) to mailbox 2 
"on the sending board. 
"Enqueue received value 
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"Read a value from msgQ (wait 
forever). The value is interpreted as 
a memory location on the VME bus. 
_"Read the channel and priority from 
the header at the received memory 
location. 

"Enqueue the memory location in 
the vcuSocket queue. 
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Sending Board 



v 

Receiving Board 



Figure 8(b) 

(sending sequence for copy to pool on receive configuration) 
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• Receive a VME bus address from the 
vcuSocket queue, based on the 
channel. 

• Read the data size from the header. - 

• Copy the data at the VME bus __ 
address to the Rx memory pool. 

• Convert the received memory 
location to indicate the local board as 
sender, add 0x20000000, and write ™ 
this to the mailbox location on the 
sending board. 

• Read from msgQ. Return an error on 
timeout. 

Put the data location, data size, channel 
configuration, and receive status into a 
reply structure. 
Enqueue the reply structure. 
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VCU Socket Task 



Read a value from msgQ(wait forever). 
Covert value to local memory value and 
release the memory location from the Tx 
memory pool. 



Sending Board 



Figure 9(a): The receiving sequence for the "Copy to Pool on Recv" configuration. 
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Application (108) 



vcuRecvO 

Call vcuSocket.RecvO 

"Receive a VME bus address 
from the vcuSocket queue, 
based on the channel. 

"Read the data size from 

the header. 

"Copy the data at the VME 
bus address to the Rx 
memory pool. 
-Convert the received 
memory location to indicate 
the local board as the 

sender, add 0x20000000, 

and write this to the 
mailbox location on the 
sending board. 
-Read from msgQ. 
Record an error on timeout 
"Write data location, data 
size, channel configuration, 
and receive status into a 
reply structure- 
Return reply structure. 

"Write data location and data size 

to input arguments. 

"Return status. 
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"Enqueue received value 




msgQ 1068 
VCU Socket Task 



"Read a value from msgQ (wait 
forever). 

"Convert value to local memory 
value and release the memory 
location from the Tx memory pool 



Sending Board 



Figure 9(b) 

(receiving sequence for copy to pool on receive configuration) 
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vcuSendO 

• Enqueue request 

• Read response from msgQ (wait 
forever) 

• Update the memory location value in 
the input argument. 

• Return status. 



msgQ msgQ 
VCU Tx Task 



0 



Read request from msgQ (wait forever). 
Call vcuSocket.Update() 

• Try to lock specified location in Tx 
memory pool. If fails, take a new 
memory location and lock it. 

• Copy data to Tx memory pool. 

• Flush cache of memory location in 
pool. 

• Unlock location in Tx memory pool. 

• If using a new memory location 
(initial lock failed), write memory 
location in pool (seen from VME bus) 
to mailbox I on destination board. 
Read from msgQ. Return a fail value 
on timeout 

Put the memory location and transmission 
status into a reply structure. 
Enqueue the reply structure. 
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ft 



msgQ 

Mailbox handler (Mailbox 2) 
Enqueue received value. 

Tx memory pool 



VME bus 
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Mailbox handler (Mailbox 1) 



Write received value (with first byte 
indicating status) to mailbox 2 on sender 
board. 

Enqueue received value. 



msgQ 



V 



VCU Socket Task 



Read a value from msgQ(wait forever). 
The value is interpreted as a memory 
location on the VME bus. 
Read the channel and priority from the 
header at the received memory location. 
Enqueue the memory location in the 
vcuSocket queue. 



Sending Board 



Receiving Board 



Figure 10: The sending sequence for the "Push to Pool on Recv" configuration 
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vcuRecvO 

• Enqueue request 

• Read reply from msgQ (wait 
forever). 

• Write data location and data size to 
input arguments. 

• Return status 



msgQ msgQ 
VCU Rx Task 



ft 



Read request from msgQ (wait forever). 
Call vcuSocket.RecvO 

• Receive a VME bus address from the 
vcuSocket queue, based on the 
channel. 

• Take a memory location in the Rx 
memory pool. 

• Write the VME bus address, the 
local address (as seen from the VME 
bus), an ID, and the channel to a 
location in the mem pair memory 
pool. 

• Add 0x40000000 to the mem pair 
memory address and write this to the 
mailbox location on the sending 
board. 



• Read from msgQ. Return a fail value 
on timeout. 

• Read response from Push msgQ (wait 
forever). Verify that response 
matches ID. 

• Read the data size from the mem pair 
memory pool, then release the slot in 
the pool. 

Put the data location, data size, channel 
configuration, and receive status into a 
reply structure. 
Enqueue the reply structure. 
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msgQ 



Mailbox handler (Mailbox 2) 



Enqueue received value 



r 



110 



VME bus 



106 



Mailbox handler (Mailbox 1 ) 



Write received value (with first byte 
indicating status) to mailbox 2 on 
receiver board. 
Enqueue received value. 



^msgQ 



VCU Socket Task 



Read a value from msgQ(wait 
forever). 

Subtract 0x40000000 from the 
received value to get a VME bus 
address. 

Read source and destination memory 
locations, channel, and ID from across 
VME bus. 

Lock the local (source) memory 
location, which is in the Tx memory 
pool. 

Write the data size across the VME 
bus 

Copy data from source to destination. 
Release the local (source) memory 
location. Clear the owner ID. Unlock 
the memory location. 
Logically AND a board-specific 
value, a bit-shifted version of the ID 
read from across the VME bus, and 
the channel. Write the result to the 
mailbox location on the receiving 
board. 

Read from msgQ. Record a fail value 
on timeout. 



msgQ 



"Mailbox handler (Mailbox 2) 



Enqueue received value 



To Figure 11(b) 



Sending Board 



Receiving Board 



Figure 11(a) 
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Rx memory pool 




Mailbox handler (Mailbox 1) 



• Write received value (with first byte 
indicating status) to mailbox 2 on 
receiver board. ~ B ~ B 

• Enqueue received value. 



msgQ 



v 



VCU Socket Task 



• Read a value from msgQ (wait 
forever). 
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Figure 11(b): The receiving sequence for the "Push to Pool on Recv" configuration. 
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Read request from msgQ (wait forever). 
Call vcuSocketSendO 

• Copy header and data to Tx memory 
pool. 

• Write memory location in pool (seen 
from VME bus) to mailbox 1 on 
destination board. ** 

• Read from queue. Return a fail value 
on timeout 

• Return status. 
Enqueue status. 
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forever). 

Covert value to local memory value 
and release the memory location from 
the Tx memory pool. 
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Mailbox handler (Mailbox 1) 



Write received value (with first byte 
indicating status) to mailbox 2 on sender 
board. 

Enqueue received value. 



msgQ 



VCU Socket Task 



Read a value from msgQ(wait forever). 

The value is interpreted as a memory 

location on the VME bus. 

Read the channel, priority, and data size 

from the header at the received memory 

location. 

Copy the data, including the data size 
portion of the header, to the vcuSocket 
queue. 

Convert the received memory location to 
indicate the local board as sender, add 
0x20000000, and write this to the 
mailbox location on the sending board. 
Read from msgQ. Return an error on 
timeout. 
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msgQ 



Mailbox handler (Mailbox 2) 



Enqueue received value 



Receiving Board 



Figure 12: The sending sequence for the "Queue on Send" 
configuration. 
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vcuRecv() 

• Enqueue request 

• Read reply from msgQ (wait forever). 

• Write data size to input argument. 

• Return status. 
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msgQ 
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VCU Rx Task 



msgQ 



Read request from msgQ (wait forever). 
Call vcuSocket.Recv() 

• Receive from the vcuSocket queue, based on the 
channel. 

• Copy the data into the location specified in the 
request. 

• Put the data size, channel configuration, and 
receive status into a reply structure. 

Enqueue receive reply structure. 



Figure 13: The receiving sequence for the "Queue on Send" configuration. 
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vcuSendO 

• Enqueue request. 

• Read status message from msgQ 
(wait forever). 

• Return status. 



msgQ 
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VCU Tx Task 



Read request from msgQ (wait forever). 
Call vcuSocket.SendToSelf() 

• Copy header and data to Rx memory 
pool. 

• Enqueue the Rx memory pool 
memory location in the vcuSocket 
queue. 

• Return status. 
Enqueue status. 
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Figure 14: The sending sequence for the "Copy to Self configuration. 
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• Enqueue request 

• Read reply from msgQ (wait forever). 

• Write data location and data size to input 
arguments. 

• Return status. 
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VCU Rx Task 



msgQ 



Read request from msgQ (wait forever). 
Call vcuSocket.RecvO 

• Receive from the vcuSocket queue, based on the 
channel. 

• Put the data, data size, channel configuration, and 
receive status into a reply structure. 

Enqueue receive reply structure. 



Figure 15: The receiving sequence for the "Copy to Self configuration. 
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vcuSendO 

• Enqueue request. 

• Read status message from msgQ 
(wait forever). 

• Return status. 
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Read request from msgQ (wait forever). 
Call vcuSocket.Send() 

• Copy header and data to Tx memory 
pool. 

• Flush cache of memory location in 
pool. 

• Write memory location in pool (seen 
from VME bus) to mailbox 1 on 
destination board. 

• Read from msgQ. Return a fail value 
on timeout. 

• Return status. 
Enqueue status. 



msgQ 

Mailbox handler (Mailbox 2) 



Enqueue received value 



Tx memory ^ool 



Mailbox handler (Mailbox 1) 



Write received value (with first byte 
masked out) to mailbox 2 on receiver 
board. — 



• Enqueue received value. 



msgQ 
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VCU Socket Task 



Read a value from msgQ (wait 
forever). 

Covert value to local memory value 
and release the memory location from 
the Tx memory pool. 
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Mailbox handler (Mailbox 1) 



Enqueue received value. 

Write received value (with first byte 

indicating status) to mailbox 2 on sender 

board. 
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VCU Socket Task 



Read a value from msgQ(wait forever). 

The value is interpreted as a memory 

location on the VME bus. 

Read the channel, priority, and data size 

from the header at the received memory 

location. 

Copy the data, including the data size 
portion of the header, to the back buffer 
of the double buffer. 

Convert the received memory location to 
indicate the local board as sender, add 
0x20000000, and write this to the 
mailbox location on the sending board. 
Read from msgQ. Record an error on 
timeout. 



ft 



msgQ 



Mailbox handler (Mailbox 2) 



Enqueue received value 



Receiving Board 



Figure 16: The sending sequence for the "Overwrite on Send" 
configuration. 
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vcuRecvO 

• Enqueue request 

• Read reply from msgQ (wait forever). 

• Write data location and data size to input 
arguments. 

• Return status. 
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msgQ 



V 



VCU Rx Task 



msgQ 



Read request from msgQ (wait forever). 
Call vcuSocket.Recv() 

• If new data has been written to the back buffer of 
the double buffer, swap the buffers. 

• Read out of the front buffer of the double buffer. 

• Put the data, data size, channel configuration, and 
receive status into a reply structure. 



Figure 17: The receiving sequence for the "Overwrite on Send" configuration. 
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vcuFree() 

• Enqueue request 

• Return status. 
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msgQ 



V 



Read request from msgQ (wait forever). 
Call vcuSocket.Free() 

• Release memory from the Rx memory pool, based 
on the chanel. 



Figure 18: The freeing sequence for the receiver-side memory pool. 
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Figure 19(a) 
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Figure 19(b) 
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VCU Configuration File Grammar: Backus-Naur Form (BNF) 



Top Level: 

<config_file>::=,channeLsection> [<include_section>] [<handler_section>] [misc_section>) 



Description: The configuration file should contain a channel declaration section and may optionally contain entries for 

include files, handler files, and other miscellaneous parameters. 



Channel Declaration Section: 



<channeLsection>::=Channels number <channel_statements> 



Description: The channel declaration should begin with the keyword "Channels" followed by a number representing the 

number of channels in the system. This is then followed by said number of channel declaration statements. 



Channel Declaration Statements: 



<channel_statements>::=<channel_statement> | <channeLstatement> <channel_statements> 
<channel_statement>::=Chan number <channel_data_type> channel_name <channel_type> 

<channel_data_type>::=[struct | class] customjtype | untyped bytejcount 
<channel_type>::=recvbuf | send | pushbuf |recvpool | pushpool |queue | self] overwrite | qself 



Description: A channel statement provides the channel number followed by the channel data type which may be a 

structure or class of user-defined customjtype, or an untyped string of bytejcount bytes. The last two tokens 
in a channel statement should be the user-defined channel_name and the channeLtype. There also should 
be as many channel statements as the number of channels declared in the beginning of the channel 
declaration section. 



Include File Section: 



<include_section>::= Include number <include_statements> 



<incJude_statements>::=,include__statement> | <include_statement> <include_statements> 



<include_statement>::= Include include JRIe 



Description: The include file section provides a number of filenames that should be "included" by the file vculnterface.h 

generated by the VCU configuration utility. The section must begin with the keyword "Include" followed by a 
number representing the number of include files in the configuration file. This is then followed by said numbet 
of include statements. Each include statement starts with the keyword "Include" and is followed by the 
filename inciude_file which should be "included" by vculnterface.h. 



Handler File Section: 



<handler_section>::=Handlers number <handler_statements> 



<handler_statements>::=<handler_statement> | <handler_statement> <handler_statements> 
<handler_statement>::=Hndlr handlrJTile 



Description: The handler file section provides a number of filenames that should be "included" by the file vcuConfig.cpp 

generated by the VCU configuration utility. The section must begin with the keyword "Handlers" followed by a 
number representing a number of handler files in the configuration file. This is then followed by said number 
of handler statements. Each handler statement starts with the keyword "Handlr" and is followed by the 
filename handler Jile which should be "included" by the vcuConfig.cpp file. 



Figure 20(a) 
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VCU Confi guration File Grammar: Backus-Naur Form (BNF) (cont) 

M iscellaneous Parameters Section: 

<misc_section>::=[<pooLparameters] [<single_parameters>] [<multiple_parameters>] 

<single parameters>::=[<ackmailbox_parameter>l [<autoackoff_parameter>] [<autoackon_parameter>] 

[datamailbox _parameter>] [<debugon_parameter>) (<mailboxqueuesize_parameter>] 
[<mempairpoolsize_parameter>] [<part*rtionaddr_parameter>] [<partitionfactor__parameter>J 
[<slavewinsize_parameter>] [<taskpriority_parameter>] * 



<multiple^arametere>::=<multiple_parameter>|<multiple_parameter> <multiple_parameters> 

<multiplejarametei>::=<dmajarameter>|<dmastartjw 

~* <rxpoolsi2ej3arameter>|<rxqueuesize^arameter>|<txpoolsize__parameter> 

Description: Single parameter options should occur only once per configuration file, while multiple parameter options may 

occur several times, usually on a per-channel basis. 



Poo! Parameters: 



<pool_parameters>::=BoardCount number [<norxpool_parameters>] [<notxpool_parameters>J 
<norxpool^arametere>::=<norxpool_parameter>|<norxpool_parameter><norxpool_parameters> 
<notxpooLparameters>::=<notxpool _parameter>|<noUpool_parameter><notxpool_parameters> 



<norxpool_parameter>::=NoRxPool chan_number board_processor_number 



<notxpool_parameter>::=NoTxPool chan__number board_processor_number 



Description- The pool parameters indicate which, if any, channel/board combinations should not allow receiving or 

transmitting respectively. The parameter list begins with the "BoardCount" keyword followed by the number of 
boards, or system processors, in the system. This is followed by one or more "NoRxPool* or "NoTxPool" 
keywords which tell the system which channel/board pairings, indicated by chanjnumber and 
board _processor_number, should not allow receiving and transmitting respectively. 



AckMaUbox Parameter: 



<ackmailbox_parameter>::=AckMailbox number 



Description: This option indicates which mailbox, represented by number, should be used for automatic 

acknowledgements. This value must be different from the Data Mailbox value, and defaults to 2. 



AutoAckOff Parameter: 



<autoackoff_parameter>::=AutoAckOff 



Description: This option indicates that auto acknowledgement should not be used in the VCU system. 

AutoAckOn Parameter: 



<autoackon_parameter>::=AutoAckOn floating_point_number 



Description: This option turns on the automatic acknowledgement feature of the VCU system. The fioating_point_n umber 
indicates the timeout value in seconds before the message is assumed lost. This value defaults to 0.05 seconds. , 

DataMailbox Parameter: " 

<datamailbox_parameter>::= Data Mailbox number 



Description: This indicates which mailbox, represented by number, should be used for inter-board communication. This 

value must be different from the AckMailbox value, and defaults to 1 . 



Figure 20(b) 
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VCU Configuration File Grammar: Backus-Naur Form (BNF) (cont.) 

Miscellaneous Parameters Section (cont): 

Debug Parameter: 

<debugon _parameter>::=DebugOn 

Description: This option turns on the printing to console all values received in the data mailbox interrupt 

Mailbox Queue Size Parameter: * 

<mailboxqueuesize_parameter>::=MailboxQueueSize size • 

Description: This option sets the size of the message queue leaving the mailbox ISR. The default size is 8. 

Memory Pair Pool Size Parameter: 

<mempairpoolsize _parameter>::=MemPairPoolSize size 

Description: This option sets the size of the memory pool for memory pairs used by ail "push" channels on the board. The 

default size is 8. 



Partition Address Parameter: 

<partitionaddr_parameter>::=PartitionAddress addr 

Description: This option sets the location of the memory partition created by the VCU for VME bus accessibility to the 

value specified in addr. 

Partition Factor Parameter: 

<partitionfactor_parameter>::=Partttion Factor factor 

Description: This option sets the factor used in setting the size of the partition. 

Slave Window Size Parameter: 

<slavewinsize_parameter>::=SlaveWindowSize half J SlaveWindowSize full 

Description: This option sets the size of the VME slave windows for boards in the system. "Half" sets the size to 

0x04000000 and "full" to 0x08000000, with the default being half. 

Task Priority Parameter: 

<taskpriority_parameter>::=TaskPriority priority 
Description: This option sets the priority for the VCU socket task. 

DMA Parameter: 

<dma _parameter>::=DMA chan^number 

Description: This option turns forces the indicated chanjnumber to always use DMA. 

DMA Start Parameter: 

<dmastart_parameter>::=DMAStart chan_number message__size 

Description: This option forces the indicated chan_number to always use DMA for messages that have sizes that are 

greater than or equal to message_size bytes. 



Figure 20(c) 
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VC U Configuration File Grammar: Backus-Naur Form (BNF) (cont.) 

Miscellaneous Parameters Section (cont): 

Event Parameter: 

<event_parameter>::=Event chan_number eventjhandler 

Description: This option specifies the routine (eventjhandler) to be called when a board receives a message for the 

channel indicated by channel_number. 

Guaranteed Delivery Parameter: 

<guaranteeddel_parameter>::=GuaranteedDelivery chan_number 

Description: This option forces the indicated chan^number to block on certain queue and pool overflows rather than risk 

losing the message. 

Receive Pool Size Parameter: 

<rxpoolsize_parameter>::=RxPoo!Size chan number size 

Description: This option sets the size of the receiving memory pool for the indicated chan_number. The default value is 8. 

Receive Queue Size Parameter: 

<rxqueuesize_parameter>::=RxQueueSize chan^number size 

Description: This option sets the size of the receiving message queue for the indicated chan_number. The default value is 

8. 



Transmit Pool Size Parameter: 

<txpoolsize_pa rameter>: :=TxPoolSize chan_number size 

Description: This option sets the size of the transmitting memory pool for the indicated chan_number. The default value is 

8. 



Figure 20(d) 
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Figure 21: Initial Dialog Window for the GUI 
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Figure 22: Primary dialog window of the GUI 
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Figure 23: The "More configuration options" dialog window 
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Figure 24: The "Board configuration" dialog window 
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Figure 25: The "VCU system configuration" dialog window 
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Figure 26: The "Writing the current configuration" dialog window 
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Figure 27: The "Writing the VCU source files" dialog window 
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Configuration: 


Receive Queue Size: 


Receive Pool Size: 


Copy on Send 


Maximum difference between the number of 
remote vcuSend() and local vcuRecv() calls. On 
overflow, the message is lost or the entire 
system blocks 


Maximum difference between the number 
of remote vcuSendO and local vcuRecvO 
calls. On overflow, the message is lost or 
the entire system blocks 


Copy to Pool on Receive 


Maximum difference between the number of 
remote vcuSend() and local vcuRecvQ calls. On 
overflow, the message is lost or the entire 
system blocks. 


Maximum difference between the number 
of vcuRecv() and vcuFree() calls. On 
overflow, vcuRecvO returns an error 


Copy to Buffer on Receive 


Maximum ainerence ueiween ine nurnutsi t» 
remote vcuSend() and local vcuRecv() calls. On 
overflow, the message is lost or the entire 
system blocks 


N/A 


Push to Pool on Receive 


Maximum number of remote sources of 
vcuSendO calls (each source has a unique ID 
and keeps track of the transmit pool address it is 
using). On overflow, the message is lost or the 
entire system blocks. 


Maximum difference between the number 
of vcuRecvO and vcuFree() calls. On 
overflow, vcuRecvO returns an error 


Push to Buffer on Receive 


Maximum number of remote sources of 
vcuSend() calls (each source has a unique ID 
and keeps track of the transmit pool address it is 
using). On overflow, the message is lost or the 
entire system blocks. 


N/A 


Queue on Send 


Maximum difference between the number of 
remote vcuSend() and local vcuRecv() calls. On 
overflow, the message is lost or the entire 
system blocks 


N/A 


Copy to Self 


Maximum difference between the number of 
vcuSendO and vcuRecv() calls. On overflow, 
vcuSendO returns an error 


Maximum difference between the number 
of vcuRecvO and vcuFree() calls. On 
overflow, vcuRecvO returns an error 


Overwrite on Send 


N/A 


N/A 
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Configuration: 


Transmit Pool Size: 


Push Queue Size: 


Copy on Send 


Maximum number of local sources of vcuSend() 
calls. On overflow, vcuSendQ returns an error. 


0 


Copy to Poo! on Receive 


Maximum difference between the number of 
local vcuSend() and remote vcuRecv() calls. On 
overflow, vcuSend() returns an error. 


0 


Copy to Buffer on Receive 


Maximum difference between the number of 
local vcuSendQ and remote vcuRecv() calls. On 
overflow, vcuSend() returns an error. 


0 


Push to Pool on Receive 


Twice the number of local sources of vcuSend() 
calls (each source has a unique ID and keeps 
track of the transmit pool address it is using). 
On overflow, vcuSend() returns an error. 


Maximum number of local sources of 
vcuSendQ calls. On overflow, vcuSendQ 
returns an error 


Push to Buffer on Receive 


Twice the number of local sources of vcuSend() 
calls (each source has a unique ID and keeps 
track of the transmit pool address it is using). 
On overflow, vcuSendQ returns an error. 


Maximum number of local sources of 
vcuSendQ calls. On overflow, vcuSendQ 
returns an error 


Queue on Send 


Maximum number of local sources of vcuSend() 
calls. On overflow, vcuSendO returns an error. 


0 


Copy to Self 


N/A 


0 


Overwrite on Send 


Maximum number of local sources of vcuSendO 
calls. On overflow, vcuSendQ returns an error. 


0 



Figure 29 
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382 



384 



Channels 6 
Chan 1 buttonPress 
Chan 2 class Eventlnfo 
Chan 3 struct NavData 
Chan 4 untyped 1024 
Chan 5 untyped 32 
Chan 6 untyped 8 
Includes 3 
Incl NavData. h 
Incl Eventlnfo. h 
Incl ButtonPress. h 
MailboxQueueSize 
DMA 1 
NCLDMA 2 
RxPoolSize 1 
TxPoolSize 1 



10 



10 
10 



^380 



BUTTON_PRESS_CHANNEL recvbuf 

EVENTJNFO_CHANNEL send 

N AV_D ATA_C HAN N E L pushbuf 

B I G_RAW_D ATA_C HAN N E L recvpool 

SMALL_RAW_DATA_CHANNEL pushpool 

SMALL_FAST_CHANNEL queue 



Figure 30: An example configuration file 
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Keyword: 


Parameters: 


Meaning: 


AckMailbox 


1 


'AckMailbox" indicates the mailbox used for the automatic acknowledgement. It should 
differ from the "DataMailbox" value. The default value is 2. 


AutoAckOff 


0 


"AutoAckOff turns off the automatic acknowledgement system for the VCU. With auto 
ack turned off, the VCU uses only one mailbox interrupt per board, but cannot 
guarantee that messages will not be lost. 


AutoAckOn 


1 


"AutoAckOn" turns on the automatic acknowledgement system for the VCU. The 
parameter sets the delay for an acknowledgement from the receiving board before the 
message is assumed lost. The default value for the parameter is 0.05 (in seconds). 


BoardCount 


1 


"BoardCount" specifies the number of boards in the system. This value is only used in 
conjunction with "NoRxPool" and "NoTxPool". 


Chan 


4 (or 5) 


"Chan" specifies a data type, channel name, and configuration type for one channel. 
Specifying "Chan" a second time for a channel resets the DMA size specs, even if they 
were changed from default by a "DmaStart" line. "Chan 0" is not allowed. Also, "Chan" 
cannot be specified before "Channels". 


Channels 


1 


"Channels" specifies the number of channels in the VCU. It should not appear more 
than once in the configuration file. 


OataMailbox 


1 


"DataMailbox" indicates the mailbox used by the VCU for inter-board communication. 
It must differ from the "AckMailbox" value. The default value is 1. 


DebugOn 


0 


Turns on printing of all values received in the data mailbox interrupt 


DMA 


1 


"DMA" specifies that the indicated channel should always use DMA. 


DmaStart 


2 


"DmaStart" specifies that the indicated channel should use DMA for any message 
larger than that specified by the second parameter (the size being in bytes). 


Event 


2 


"Event" specifies a routine that should be called as soon as a board receives data on 
the indicated channel. The first parameter is the channel, and the second parameter is 
the routine (the routine preferably cannot take any input argument and cannot return 
any value). 


Guaranteed Delivery 


1 


"GuaranteedDelivery" indicates that the channel will block on certain queue and pool 
overflows, rather than lose the message. The queue and pool overflows in question 
are those that are unreportable as returns to vcuSend(), vcuRecv(), or vcuFree() calls. 
Blocking on these overflows blocks all incoming messages for the board in question 
and can result in other queues and pools overflowing. 


Handlers 




"Handlers" specifies the number of files to be included in the vcuConftg.cpp file. It 
should not be called twice. 


Hndlr 




"Hndlr" specifies a file to be included in the vcuConfig.cpp file. If too many or too few 
files are specified, the autoConfig code declares the configuration invalid. "Hndlr" 
should not be specified before "Handlers". 


Includes 




"Includes" specifies the number of files to be included in the file vculnterface.h. 
"Includes" should not be called more than once. 


Incl 




"Incl" specifies a file to be included in the file vculnterface.h. If too many or too few 
files are specified, the autoConfig code declares the configuration invalid. "Incl" should 
not be specified before "Includes". 


MaiiboxQueueSize 




"MaiiboxQueueSize" specifies the size of the msgQ leaving the mailbox ISR. The 
default value is 8. 


MemPairPoolSize 




"MemPairPoolSize" specifies the size of the memory pool for memory pairs (used in 
the "push..." configuration types). This is a board-wide memory pool, used by all 
channels. The default value is 8. 
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Keyword: 


Parameters: 


Meaning: 


No_DMA 


1 


"No_DMA" specifies that the indicated channel should never use DMA. 


NoRxPool 


2 


"NoRxPool" specifies a channel and board where the VCU should not support receive 
operations. The first parameter is the channel ajd the second parameter is the board's 
system processor number. If NoRxPool is specified for any board in a channel, then 
the system processor numbers should be in the range of 0 to BoardCount-1. 


NoTxPool 


2 


"NoTxPool" specifies a channel and board where the VCU should not support transmit 
operations. The first parameter is the channel and the second parameter is the board's 
system processor number. If NoTxPool is specified for any board in a channel, then 
the system processor numbers should be in the range of 0 to BoardCount-1 . 


Partition ArirlrPQ^. 
r 0(111101 ITAUU 1 639 


1 


"PartitionAddress" specifies the location of the memory partition created by the VCU for 
VME bus accessibility. 


PartitionFactor 


1 


-PartitionFactor" specifies the factor used in setting the size of the partition. Buffers 
used to receive data in the "push to buffer on receive" configuration type are allocated 
from here, so these drive the size of the partition factor. The factor also allows for 
fragmented allocation because of the memory alignment specified in the allocation. 


RxPoolSize 


2 


•RxPoolSize" specifies the size of the receiving memory pool for a channel. The first 
parameter is the channel, and the second parameter is the pool size. The default 
value is 8. 


l\A\il U w W w W w 


2 


"RxQueueSize" specifies the size of the receiving queue for a channel. The first 
parameter is the channel, and the second parameter is the queue size. The default 
value is 8. 


RxReplyQueueSize 


1 


-RxReplyQueueSize" specifies the size of the queue delivering responses from the 
VCU Rx Task to the vcuRecvO routine. 


RxRqstQueueSize 


1 


■RxRqstQueueSize" specifies the size of the queue delivering vcuRecv{) requests to 
the VCU Rx Task. 


RxTaskCount 


1 


-RxTaskCount" specifies the number of tasks set aside to handle vcuRecvO calls. The 
first task handles all non-blocking calls, while the other tasks handle blocking calls. 
The minimum value should be 2 unless vcuRecvQ will never be called as blocking. 
The default value is 4. 


SlaveWindowSize 


1 


"SlaveWindowSize" specifies the size of the slave windows for boards in the system. 
The valid options are "hair and "full", which correspond to 0x04000000 and 
0x08000000. The default value is "half. 


TaskPriority 


2 


-TaskPriority" specifies the priority of the indicated task, "Socket". Tx", "Rx", or 
"Debug". The default value is 100 for all tasks. 


TxPoolSize 


2 


"TxPoolSize" specifies the size of the transmitting memory pool for a channel. The first 
parameter is the channel, and the second parameter is the pool size. The default 
value is 8. 


TxReplyQueueSize 


1 


"TxReplyQueueSize" specifies the size of the queue that delivers update responses 
from the VCU Tx Task to the vcuSend() routine. 


TxRqstQueueSize 


1 


"TxRqstQueueSize" specifies the size of the queue that delivers vcuSend() requests to 
the task that actually performs the data transmission (the VCU Tx Task). 


TxStatusQueueSize 


1 


TxStatusQueueSize" specifies the size of the queue that delivers status responses 
from the VCU Tx Task to the vcuSend() routine. 
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Constant: 


Value: 


Meaning: 


VCU_ERROR_NCLCODE 


0x1 


Mainly used internally, but also used as a return value for a multicast 
"vcuRequestErrnoO" so this routine can be used to check whether any 
enors exist in the system 


VCU_SUCCESS 


0x2 


The VCU command operated successfully 


VCU_RECV_EMPTY 


0x3 


The non-blocking vcuRecv() command found no message. 


VCU_BAD_CHANNEL 


0x4 


An unexpected channel was received. This can be directly, from an API 
call, or indirectly, from data corrupted when copied across the VME bus. 


VCU_MSGQ_FULL 


0x5 


Used internally on a vcuSend() when the channel is configured for copy to 
self. 


VCU_POOL_FULL 


0x6 


The vcuSend() or vcuRecv() call could not find sufficient memory space in 
the memory pool to perform the send or receive. 


VCU_NO_RECV_TASK 


0x7 


The vcuRecv() call is a blocking call, but no task is available for a blocking 
receive call. To fix: configure the system to have more receive tasks. 


VCU_ERR_ON_RECV 


0x10000 


The error occurred in a section of code responsible for receiving. The 
code is most likely specific to handling vcuRecv(). 


VCU_ERR_ON_SEND 


0x20000 


The error occurred in code specific to handling vcuSend(). 


VCU_ERR_ON_FREE 


0x30000 


The error occurred in code specific to handling vcuFree 0- 


VCU_ERR_ON_PING 


0x40000 


The error occurred in code specific to handling vcuPingO- 


VCU_ERR__ON_TEST_PAT 


0x50000 


The error occurred in code specific to handling vcuRequestTestPattem(). 


VCU_ERR_ON_CONFIG 


0x60000 


The error occurred at initialization 


VCU_ERR_ON_ERRNO 


0x70000 


The error occurred in code specific to handling vcuRequestErmoO- These 
error numbers are not stored, so that stored errors can be differentiated 
from errors that occur at the time of the request 


VCU_ERRJN_SOCKET 


0x01000 


The error occurred in code in VcuSocketcpp. 


VCU_ERR_IN_RXQUEUE 


0x02000 


The error occurred during an RxQueues method. 


VCU_ERRJN_MAILBOX 


0x03000 


The error occurred in mailbox management, in the file VcuMailbox.cpp. 


VCU_ERR_IN_INTERFACE 


0x04000 


The error occurred in the interface to the vcuSocket, in VcuComm.cpp. 


VC U_ERR_IN_RX_TASK 


0x05000 


The error ocfurreri in rnHp in VruPnmm rnn in Innir* cr-K»r*rfir* tn Pv TocU 

management. 


VCU_ERRJN_TX_TASK 


0x06000 


The error occurred in code in VcuComm.cpp in logic specific to Tx Task 
management. 


VCLLERR_IN_VME_COPY 


0x07000 


The error occurred in code responsible for copying data across the VME 
bus. 


VCU_ERR_IN_RXPOOL 


0x08000 


The enor occurred in a RxPools method. 


VCU_ERR_IN_TXPOOL 


0x09000 


The error occurred in a TxPools method. 


VCU_ERR_IN_PAIRPOOL 


OxOaOOO 


The error occurred in a MemPairPool method. 


VCU_ERRJN_ACK 


OxObOOO 


The error occurred in code responsible for handling an automatic 
acknowledgement. 
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Constant: 


Value: 


Meaning: 


VCU_ERR_NO_MEMORY 


0x00010 


The error occurred when requested memory is unavailable. 


VCU_ERR_MSGQ_RECV 


0x00020 


The error occurred while trying to receive from a msgQ. 


VCU_ERR_DATA_SYNCH 


0x00030 


The error occurred when VcuSocket tried to free a memory pool slot 
already freed or during RequestDataPushQ when the incorrect identifier 
came back. The latter requires rewriting the Push communication 
protocol. 


VCU_ERRJNTERNAL 


0x00040 


The error occurred when the flow reached a section of code it should not 
have reached. 


VCU_ERR_BAD_POOL_SLOT 


0x00050 


The error occurred when the VcuSocket tried to FreeO memory that did 
not come from the pool specified. 


VCU__ERR_BAD_MAILBOX 


0x00060 


The error occurred when the VcuSocket tried to TriggerRemoteBoard() to 
itself or a destination outside the system boundaries. 


VCU_ERR_BAD_MCAST 


0x00070 


The error occurred because the VCU was reconfigured so that the 
destinations are not specified bitwise, or a multicast was attempted on a 
channel configured for updating ("push ...") 


w/-»l I CD D 1 1KII PlP^ PAII FD 
VGU_fcKK_UiNl_wOr\_rA\li_tL' 


0x00080 


The error occurred during Update() when the system was unable to unlock 
a memory slot it just locked. This should never occur. 


i//->H EDO MQfiO Pill 1 


0x00090 


The error occurred when a send to a msgQ found the msgQ full. 


VCU cK^MobU^ociNU 


OxOOOaO 


The error occurred while trying to send to a msgQ. The error is not a full 
msgQ error. 


VCU_ERR_BAD_CONFIG 


OxOOObO 


The error occurred when the VCU tables were in conflict with the kernel 
configuration. 


VCU_ERR_TRIG_FA1LED 


OxOOOcO 


The error should only occur when automatic acknowledgement is enabled. 
The enor means that the automatic ack was not received. vcuPing() can 
be tried to make sure that the board is accessible. The return value is 
VCU_SUCCESS for a successful vcuPing(). 


VCU_ERR_MSGJTOO_BIG 


OxOOOdO 


The error occurred when the size of the message was larger than the 
capacity of the channel. 


VCU_ERR_DEST_INVAUD 


OxOOOeO 


The error occurred when a vcuPingO or vcuRequestTestPattem() found 
an invalid destination specified. 


VCU_ERR_TASK_DIED 


OxOOOfO 


The error occurred when a receive task is found to be inaccessible. 


VCU_ERR__VME_DMA 


0x00100 


The error occurred when a sysVmeDmaCopyO returned an error value. 


VCU_ERRJSR_USE 


0x00200 


The error occurred when vcuSend() was called from an ISR. 


VCU_MBOX_FULL_QUEUE 


Oxff 


The error occurred when the receiver's mailbox ISR found its outgoiri 
msgQ full. The message is lost, but the sender gets an error message. 


VCU_MBOX_QUEUE_ERROR 


Oxfe 


The error occurred when the receiver's mailbox ISR found its outgoing 
msgQ broken (not just full). The message is lost, but the sender gets an 
error message. All further messages are likely to get the same response. 
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Application 



vcuSendO 

Call vcuSocketSendToSelfO- 

• Enqueue message in the Rx 
pool 

• Return status 
Return status 



Figure 34: The sending sequence for the "Queue to selP configuration. 



Application 



vcuRecvO 

Call vcuSocket.RecvO 

• Receive from the vcuSocket queue, based on the 
channel. 

• Copy the data into the location specified in the 
calling argument. 

• Write the message size into the calling 
argument. 

• Return status 
Return status 



Figure 35: The receiving sequence for the "Queue to self" configuration 
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